home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
SGI Performance Co-Pilot 1.3
/
SGI Performance Co-Pilot 1.3.iso
/
dist
/
pcp.idb
/
usr
/
share
/
catman
/
u_man
/
cat1
/
mkaf.z
/
mkaf
Wrap
Text File
|
1997-04-03
|
5KB
|
133 lines
MMMMKKKKAAAAFFFF((((1111)))) MMMMKKKKAAAAFFFF((((1111))))
NNNNAAAAMMMMEEEE
mmmmkkkkaaaaffff - create a Performance Co-Pilot archive folio
SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
////uuuussssrrrr////ppppccccpppp////bbbbiiiinnnn////mmmmkkkkaaaaffff _f_i_l_e_n_a_m_e ...
DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
A collection of one or more Performance Co-Pilot (PCP) archive logs may
be combined with mmmmkkkkaaaaffff to produce a PCP archive folio and the associated
archive folio control file. Certain other PCP tools use mmmmkkkkaaaaffff to create
archive folios, e.g. the ``record'' facility in the ppppmmmmcccchhhhaaaarrrrtttt(1) tool
creates PCP archive folios.
Once created, the archive folio may be processed using ppppmmmmaaaaffffmmmm(1).
mmmmkkkkaaaaffff processes each _f_i_l_e_n_a_m_e argument, and if this is a component file
from a PCP archive that archive is added to the folio.
If _f_i_l_e_n_a_m_e is a directory, then this is searched recursively using
ffffiiiinnnndddd(1). Any _f_i_l_e_n_a_m_e argument beginning with a ``-'' is assumed to be a
ffffiiiinnnndddd(1) command line option; the default is ----ffffoooolllllllloooowwww.
The folio control file is written to standard output, and has the
following format.
1. The first line contains the word PPPPCCCCPPPPFFFFoooolllliiiioooo.
2. The second line contains the tag VVVVeeeerrrrssssiiiioooonnnn:::: followed by the format
version number (currently 1).
3. For subsequent lines, blank lines and lines beginning with ``#'' are
ignored.
4. The line beginning with the tag CCCCrrrreeeeaaaatttteeeedddd:::: documents where and when the
folio was created.
5. The line beginning with the tag CCCCrrrreeeeaaaattttoooorrrr:::: identifies the tool which
created the folio. If present, the second argument is the name of a
configuration file that the creator tool could use to replay the
archive folio, e.g. with the rrrreeeeppppllllaaaayyyy command for ppppmmmmaaaaffffmmmm(1).
6. Then follow one or more lines beginning with the tag AAAArrrrcccchhhhiiiivvvveeee:::: and
followed by the hostname and base name of the archive.
For example
$ mkaf /var/adm/pcplog/gonzo
might produce the following folio control file.
PCPFolio
Version: 1
# use pmafm(1) to process this PCP archive folio
#
PPPPaaaaggggeeee 1111
MMMMKKKKAAAAFFFF((((1111)))) MMMMKKKKAAAAFFFF((((1111))))
Created: on gonzo at Tue Jul 2 03:35:54 EST 1996
Creator: mkaf
# Host Basename
#
Archive: gonzo /var/adm/pcplog/gonzo/960627
Archive: gonzo /var/adm/pcplog/gonzo/960628
Archive: gonzo /var/adm/pcplog/gonzo/960629
Archive: gonzo /var/adm/pcplog/gonzo/960630
Archive: gonzo /var/adm/pcplog/gonzo/960701
Archive: gonzo /var/adm/pcplog/gonzo/960701.00.10
Archive: gonzo /var/adm/pcplog/gonzo/960701.05.25
Archive: gonzo /var/adm/pcplog/gonzo/960702.00.10
SSSSEEEEEEEE AAAALLLLSSSSOOOO
ffffiiiinnnndddd(1), ppppmmmmaaaaffffmmmm(1) and ppppmmmmcccchhhhaaaarrrrtttt(1).
DDDDIIIIAAAAGGGGNNNNOOOOSSSSTTTTIIIICCCCSSSS
Some informational messages, warnings and pathological conditions are
reported on standard error.
PPPPaaaaggggeeee 2222